# Unit Detail

# Unit Monitoring

#### Acknowledging Alarms

#### Alarm Log Selection

#### Alarm Types Filter

#### All Alarms

#### All Units

#### DLCI Status Information

#### Element Status

#### Enabling/Disabling Unit Monitoring

#### How Monitoring Works

#### Individual Alarms

#### Individual Unit

#### Informational Alarms

#### NetView PU Reset

#### Port Status

#### PU Status Information

#### Unit Filter

#### Unit Status Information

#### Viewing a Dump File Status

#### Viewing a NetView PU’s Status

#### Viewing a Summary of Units

#### Viewing a Unit’s Detailed Status

#### Viewing Overall Unit Status

#### Viewing Statistics

#### Viewing the Alarm Log

#### Viewing the Poll Log

#### Viewing the Unit’s Status

  This chapter describes how ControlSight monitors units and how to use this function to check the status and statistics of these monitored units.
  Note: Depending upon the type of unit you are monitoring, some of the following features may or may not be available. If a feature is not available for the unit your are monitoring, the feature will not be present, or will appear ghosted.

#### How Monitoring Works

  Upon start-up, ControlSight polls each unit defined in its database for initial status. If ControlSight is unable to contact a unit, it continues polling until the unit responds or reaches the out-of-control threshold limit.
  The unit status ribbon displays the status and configuration details. ControlSight updates these summaries at the configured poll rate.
  For example, if a previously functional unit fails to respond to a poll, ControlSight changes its status ribbon from green to yellow, then red.
  ControlSight communicates directly with the SNMP agent running on each unit, eliminating the need for permanent connections. ControlSight polls the SNMP agent to determine the unit’s current status.

#### Viewing Overall Unit Status

  Color codes indicate a unit’s overall status. This status reflects activity at the PU, port, and unit level. The displayed color reveals only the highest level alarm.
  Unit Status Color Codes
  1. White (No status) ~ The non-polling ControlSight was invoked or the unit is not monitored.
  2. Green (Normal) ~ The unit was contacted, its ports are enabled, and its PU's are in session.
  3. Mustard (Marginal) ~ The unit's line quality is marginal.
  4. Yellow (Minor) ~ The unit has not responded to the last poll (out of contact), or a port/PU failed.
  5. Dark Red (Major) ~ A PU is inactive (not in session).
  6. Red (Critical) ~ The unit has not responded to repeated session initiation attempts from the ControlSight workstation.
  7. Gray (Unknown) ~ The unit has not responded to a poll from the ControlSight workstation.
  8. Blue (Disabled) ~ The port or PU was disabled by the operator.
  9. Magenta (Informational) ~ On of the following conditions exists:
  A NetView PU is not in session.
  A dump file exists on the unit.
  The software version listed in the database for this device does not match the version loaded on the device. Use the configuration editor to reload the correct version onto the unit.
  The Configuration ID listed in the database for this unit does not match the CID of the configuration loaded on the device. Use the configuration editor to clear this condition, then reinstall the configuration.

#### Viewing a Unit’s Detailed Status

  You can view a detailed status from the Unit Detail window. Through this window, you may modify how to display unit alarms.
  Note: If you are managing the unit via IP and launch Unit Detail, the unit may go out of contact for a short time. This momentary condition does not affect the functionality of the unit in any way. It simply takes Envisage a few moments to update the actual status.
  To open this window, double-click the status ribbon of the unit you want to view.
  To return to the global status window, select the Close option from the Window menu.
  Use the Jump menu to access the configuration editor, file transfer, NMS session, and poll log screens for this unit.
  Unit Detail Options
  1. View Mode ~ Displays the current view mode. Both the global status and Unit Detail windows display
  status for the current view mode (actual status or unacknowledged alarms).
  2. Toggle Mode ~ Enables you to toggle the view mode between Actual Status and unacknowledged Alarms
  3. Acknowledge All Alarms ~ Click this button to clear all alarms and return all status to normal operation (green).
  4. Port Panel View ~ This graphical representation of the unit's port panel displays the status of each port. To
  access port and alarm functions, select a port, then click your right mouse button.
  5. Unit Panel ~ Click inside the unit, not on a port, then click your right mouse button to access the options
  for that unit.
  6. Tabs ~ Click a tab to access its associated page:Unit PUs or DLCIs.
  7. Tab Page ~ Pages display details regarding the PU, unit, and line..
  Note: If you have enables the “Use Agent Consolidated Status” option and choose to ignore the status of an element, it will affect this element on all Envisage workstations that are monitoring the unit.

#### Port Status

  The port panel view shows the port status using one of the color codes identified.
  Port Status Color Codes
  1. White (No status) ~ No status was reported because the port's Ignore Status option is enabled.
  2. Green (Normal) ~ The port is enabled.
  3. Mustard (Marginal) ~ The unit's line quality is marginal. If the port is a Frame Relay port with a DLCI associated
  with the Dial Backup function, this color indicates the port is ready to be rehomed.
  4. Yellow (Minor) ~ The port has failed.
  5. Blue (Disabled) ~ The port is disabled.
  To open the port pop-up menu, select a port and click your right mouse button.
  The port pop-up menu contains two options: Status Information and Statistics. These options are available only if the selected unit is managed through IP/SNMP.

#### Unit Status Information

  To access unit status and statistic information, select the unit and click the right mouse button to open the pop-up menu.
  You can view the unit statistics only if the unit is managed through IP/SNMP.
  For more information regarding Bridge and IP status options, refer to the FrameNode Advanced Topics Configuration Guide.

#### Viewing the Unit’s Status

  Click the Unit tab to view the global status information.

#### Viewing a Dump File Status

  If a system error occurs, the unit dumps the memory contents to a file and sends an alarm to the ControlSight workstation, informing you of the dump file.
  To acknowledge a dump file alarm, click inside the Dump File field and click your right mouse button. Select Acknowledge Alarm to clear the alarm and return the status to normal operation.
  Note: This feature is not available on the FRAP and T-FRAP.

#### Viewing a NetView PU’s Status

  If you configured one or both NetView Plus, their status appears in the Session fields in the Unit tab page.
  To acknowledge a NetView PU’s status alarm, click inside the NetView Session field and click your right mouse button. Select Acknowledge Alarm from the pop-up menu to clear the alarm and return the status to normal operation.

#### NetView PU Reset

  If a NetView PU becomes locked up, or confused, it can be reset by clicking the right mouse button over the NetView PU that needs to be reset. From the Pop-up menu, select Restart Connection.

#### PU Status Information

  Click the Plus tab to view a PU’s status. The list displays PUs by port and PU number.
  Note: This window may display PUs by their NAU name if you selected Use NAU Names in the Customize dialog box.
  To access the PU menu, select a PU, then click your right mouse button.
  Note: Two of the PU menu options, Status Information and Statistics, are available only if the selected unit is managed through IP/SNMP.
  PU Status Color Codes
  1. White (No status) ~ No status was reported because the PU's Ignore Status option is enabled.
  2. Green (Normal) ~ The PU is enabled and in session (active).
  3. Yellow (Minor) ~ The PU has failed.
  4. Dark Red (Major) ~ The PU is not in session (inactive).
  5. Blue (Disabled) ~ The PU is disabled.
  6. Gray (Unknown) ~ The port is out of service. Status unknown.

#### DLCI Status Information

  Click the DLCIs tab to view the status of each virtual port on a frame relay network.
  To open the DLCI menu, select a DLCI, then click your right mouse button.
  Note: The InSight option is only available if the optional InSight software is installed. For more information regarding this feature, please see Appendix C- “InSight”.
  DLCI Status Color Codes
  1. White (No status) ~ No status was reported because the port's Ignore Status option is enabled.
  2. Green (Normal) ~ The DLCI is active.
  3. Red (Critical) ~ The DLCI is inactive.
  4. Yellow ~ The DLCI state is invalid.
  The Spanning Tree status may include one of the following entries:
  Disabled - the port is disabled.
  Blocking - the port is blocking bridged traffic.
  Listening - the port is listening to all packets.
  Learning - routing information is being learned.
  Forwarding - the port is forwarding bridged traffic.
  Broken - the port is malfunctioning.
  The spanning tree topology is dynamic and may change at any time. The spanning tree state field does not update in real-time. To refresh the spanning tree state field, click the Update button.

#### Acknowledging Alarms

  To View only unacknowledged alarms for a unit, click the Toggle Mode button in the Unit Detail window.
  Unacknowledged alarm mode enables you to view only the elements with pending alarms. If you acknowledge alarms in this mode, the element’s status changes to green.

#### All Alarms

  If you want to acknowledge all alarms without reviewing them, click the Acknowledge All Alarms button.
  Once you have acknowledged all alarms, the unit’s status ribbon changes to green, indicating normal operation.
  You can return the status of each element to its original alarm state by clicking the opening the Window menu and selecting Update Status, or restarting Control Sight.

#### Informational Alarms

  Informational alarms are non-critical. One or more of the following conditions have occurred:
  Error occurred on an access line.
  Configured NetView PU is not in session.
  CID or software version mismatch may exist.
  Acknowledging informational alarms returns the unit’s status to normal operation (green).
  Informational alarms are the lowest reported alarm. You must acknowledge all alarms before the unit status ribbon returns to green.
  To acknowledge informational alarms, click inside the port panel graphic (not on a port), then click your right mouse button. From the menu, select Acknowledge Info Alarms.

#### Individual Alarms

  By acknowledging alarms individually, you can review each alarm and its associated element.
  To do this, follow these steps:
  1. Select the element you want to acknowledge.
  2. Click the right mouse button.
  3. Select Acknowledge Alarm from the menu.
  As you acknowledge each alarm, the status ribbon changes to reflect the next highest level alarm for that unit, if one exists. After you acknowledge all alarms for a specific unit, the status ribbon changes to green to indicate normal operation.
  Note: Even though the unit’s status changes to green, the condition that caused the alarm is not necessarily fixed. If you want to view the actual status of the unit, enter the Unit Detail window and switch to Actual Status view mode. Open the Window menu and select Update Status.
  In Actual Status view mode, alarms may clear only from the status ribbon, not from the Unit Detail window.

#### Element Status

  If you set the Unit Detail feature to ignore the status of any configured element, the status color turns white.
  Note: If you choose to ignore the status of an element, ControlSight continues to ignore it until you disable the Ignore Status option for that element.
  To ignore an element’s status, select the element from the port panel view, click your right mouse button, and select Ignore Status from the menu.

#### Viewing the Alarm Log

  You may use the Alarm Log Viewer to review selected types of alarms that ControlSight accumulates automatically in its alarm buffer. When this buffer becomes full, the program deletes its oldest alarm record to make room for newer alarms.
  Note: This alarm log is not related to the alarm log file generated when alarm logging is enabled in the Customize dialog box.
  ControlSight enables you to view alarms accumulated for all monitored units. This feature enables you to filter out selected alarm types by unit, port, or PU. You may view the alarms either on-line or print them on your default printer.
  By default, this feature displays all alarms accumulated throughout the current day. As an alternative, you may view alarms accumulated for any of the previous six days, up to the buffer’s maximum capacity.
  To open this alarm log from ControlSight’s main screen, either click the Alarm icon or select the Alarm Viewer option from the Tools menu.
  To update the displayed alarms, click the Refresh button.
  To send a copy of the currently displayed alarm log to your default printer, click the Print button.
  When you’ve finished viewing this alarm log, click Exit to close this dialog box.

#### Alarm Log Selection

  The upper-left corner of the Alarm Log Viewer presents the date of the currently displayed alarm log. The field below the date identifies which day of the week the displayed alarm events occurred.
  To select an alarm log for a different day of the week, click the down arrow to open the week day scroll list and select the desired day of the week. The Alarm Log Viewer updates the displayed list with alarm details that accumulated during the selected date.

#### Alarm Types Filter

  The buttons at the top of the Alarm Log Viewer enable you to filter out alarms types that do not match selected criteria.
  To limit the list to alarms generated for ports or PUs, follow these steps:
  1. Click the Set Alarm Filter button. A dialog box appears.
  2. Click the check box next to each type of alarm you want to view: Port Alarms or PU Alarms.
  3. Click OK. This dialog box closes and the alarm log displays only those selected alarm type.

#### Unit Filter

  To limit the list to alarms generated on a specific unit, follow these steps:
  1. Click the Set Unit Filter button. A dialog box appears.
  2. Click the name of the unit whose alarm log you want to review. If the selected unit’s configuration file includes a
  description, it appears in the Description column.
  3. Click OK. This dialog box closes and the alarm log displays only alarms generated on the selected unit.

#### Viewing the Poll Log

  ControlSight maintains a poll log of connection attempts for each unit in the database. After the ControlSight workstation connects to a unit, it remains connected until deliberately disconnected or a failure occurs.
  To view a unit’s poll log, select the unit from the global status window, then click the Poll Log icon.
  When an unsuccessful attempt or disconnect occurs, a diagnostic message appends to the listed condition.

#### Enabling/Disabling Unit Monitoring

  Disabling unit monitoring prevents ControlSight from polling the selected units each time the application launches. You may enable or disable monitoring for one or all units.

#### Individual Unit

  To disable unit monitoring, select the unit you do not want monitored, open the Unit menu, and select Monitor Unit.
  This clears the check mark from the option, indicating a disabled unit.
  To enable unit monitoring, select the unit you want monitored, open the Unit menu, and select Monitor Unit.
  This adds a check mark to the option, indicating an enabled unit.

#### All Units

  To disable monitoring on all units, open the Network menu and select UnMonitor All Units.
  To enable monitoring on all units, open the Network menu and select Monitor All Units.

#### Viewing Statistics

  When managing units through IP/SNMP, you can view statistics for any configured element by selecting Statistics form the element’s pop-up menu in the Unit Detail window.
  For example, to view statistics for a port, select the port from its panel view, then click your right mouse button and select Statistics from the menu.

#### Viewing a Summary of Units

  To view a summary of the units you have configured, open the Network menu and select Summary of Units.